Developer --> Technical Publications
PATHMac OS 8 Developer Documentation > Human Interface Toolbox > Window Manager >

Mac OS 8 Window Manager Reference


Window Definition IDs

Window definition IDs are changed with Appearance Manager 1.0. The Window Manager now provides many new, standard, Appearance-compliant window types.

Your application typically supplies a window definition ID to a resource of type 'WIND' or to a window-creation function to specify which window definition function to use in creating the window. A variation code may also be used to describe variations of the same basic window.

The window definition ID is an integer that contains the resource ID of the window definition function in its upper 12 bits and a variation code in its lower 4 bits. For a given resource ID and variation code, the window definition ID is derived as follows:

window definition ID = (16 x resource ID) + variation code.

See Window Resource IDs and Window Definition Variation Codes for descriptions of possible values.

If you wish to create a custom window, you can write your own window definition function. For an example, see MyWindowDefProc.

IMPORTANT

The window definition IDs for dialog boxes and utility (floating) windows pertain to the appearances of these windows only, not their behaviors. For example, if you want a utility window to have the proper behavior, that is, float, your application must provide for it.

When mapping is enabled, standard pre-Appearance window definition function IDs will be mapped to their Appearance-compliant equivalents. Table 1-1 lists the standard pre-Appearance and Appearance-compliant window definition ID constants.

Table 1-1  Pre-Appearance and Appearance-compliant window definition IDs

Pre-Appearance window

Appearance-compliant window

Description

dBoxProc kWindowModalDialogProc Modal dialog box
None kWindowAlertProc Modal alert box
movableDBoxProc kWindowMovableModalDialogProc Movable modal dialog box
None kWindowMovableModalGrowProc Movable modal dialog box with size box
None kWindowMovableAlertProc Movable modal alert box
plainDBox kWindowPlainDialogProc Modeless dialog box
altDBoxProc kWindowShadowDialogProc Modeless dialog box with shadow
noGrowDocProc kWindowDocumentProc Movable window with no size box
documentProc kWindowGrowDocumentProc Movable window with size box
zoomNoGrow kWindowFullZoomDocumentProc Movable window with full zoom box and no size box
zoomDocProc kWindowFullZoomGrowDocumentProc Movable window with full zoom box and size box
None kWindowVertZoomDocumentProc Movable window with vertical zoom box and no size box
None kWindowVertZoomGrowDocumentProc Movable window with vertical zoom box and size box
None kWindowHorizZoomDocumentProc Movable window with horizontal zoom box and no size box
None kWindowHorizZoomGrowDocumentProc Movable window with horizontal zoom box and size box
rDocProc None (use rDocProc) Round-cornered window
floatProc kWindowFloatProc Utility window with no size box or zoom box
floatGrowProc kWindowFloatGrowProc Utility window with size box
floatZoomProc kWindowFloatFullZoomProc Utility window with full zoom box
floatZoomGrowProc kWindowFloatFullZoomGrowProc Utility window with full zoom box and size box
None kWindowFloatVertZoomProc Utility window with vertical zoom box
None kWindowFloatVertZoomGrowProc Utility window with vertical zoom box and size box
None kWindowFloatHorizZoomProc Utility window with horizontal zoom box
None kWindowFloatHorizZoomGrowProc Utility window with horizontal zoom box and size box
floatSideProc kWindowFloatSideProc Utility window with side title bar and no size box or zoom box
floatSideGrowProc kWindowFloatSideGrowProc Utility window with side title bar and size box
floatSideZoomProc kWindowFloatSideFullZoomProc Utility window with side title bar and full zoom box
floatSideZoomGrowProc kWindowFloatSideFullZoomGrowProc Utility window with side title bar, size box, and full zoom box
None kWindowFloatSideVertZoomProc Utility window with side title bar and vertical zoom box
None kWindowFloatSideVertZoomGrowProc Utility window with side title bar, vertical zoom box, and size box
None kWindowFloatSideHorizZoomProc Utility window with side title bar and horizontal zoom box
None kWindowFloatSideHorizZoomGrowProc Utility window with side title bar, horizontal zoom box, and size box
enum {
    documentProc                        = 0,
    dBoxProc                            = 1,
    plainDBox                           = 2,
    altDBoxProc                         = 3,
    noGrowDocProc                       = 4,
    movableDBoxProc                     = 5,
    zoomDocProc                         = 8,
    zoomNoGrow                          = 12,
    rDocProc                            = 16,
    kWindowDocumentProc                 = 1024,
    kWindowGrowDocumentProc             = 1025,
    kWindowVertZoomDocumentProc         = 1026,
    kWindowVertZoomGrowDocumentProc     = 1027,
    kWindowHorizZoomDocumentProc        = 1028,
    kWindowHorizZoomGrowDocumentProc    = 1029,
    kWindowFullZoomDocumentProc         = 1030,
    kWindowFullZoomGrowDocumentProc     = 1031,
    kWindowPlainDialogProc              = 1040,
    kWindowShadowDialogProc             = 1041,
    kWindowModalDialogProc              = 1042,
    kWindowMovableModalDialogProc       = 1043,
    kWindowAlertProc                    = 1044,
    kWindowMovableAlertProc             = 1045,
    kWindowMovableModalGrowProc         = 1046,
    kWindowFloatProc                    = 1057,
    kWindowFloatGrowProc                = 1059,
    kWindowFloatVertZoomProc            = 1061,
    kWindowFloatVertZoomGrowProc        = 1063,
    kWindowFloatHorizZoomProc           = 1065,
    kWindowFloatHorizZoomGrowProc       = 1067,
    kWindowFloatFullZoomProc            = 1069,
    kWindowFloatFullZoomGrowProc        = 1071,
    kWindowFloatSideProc                = 1073,
    kWindowFloatSideGrowProc            = 1075,
    kWindowFloatSideVertZoomProc        = 1077,
    kWindowFloatSideVertZoomGrowProc    = 1079,
    kWindowFloatSideHorizZoomProc       = 1081,
    kWindowFloatSideHorizZoomGrowProc   = 1083,
    kWindowFloatSideFullZoomProc        = 1085,
    kWindowFloatSideFullZoomGrowProc    = 1087,
    floatProc                           = 1985,
    floatGrowProc                       = 1987,
    floatZoomProc                       = 1989,
    floatZoomGrowProc                   = 1991,
    floatSideProc                       = 1993,
    floatSideGrowProc                   = 1995,
    floatSideZoomProc                   = 1997,
    floatSideZoomGrowProc               = 1999
};

Constant descriptions

documentProc
Pre-Appearance document window (movable window with size box).
dBoxProc
Pre-Appearance modal dialog box.
plainDBox
Pre-Appearance modeless dialog box.
altDBoxProc
Pre-Appearance modeless dialog box with shadow.
noGrowDocProc
Pre-Appearance movable window with no size box or zoom box.
movableDBoxProc
Pre-Appearance movable modal dialog box.
zoomDocProc
Pre-Appearance movable window with size box and full zoom box.
zoomNoGrow
Pre-Appearance window with full zoom box and no size box.
rDocProc
Pre-Appearance rounded-corner window. You can control the diameter of curvature of a rounded-corner window (window type rDocProc ) by adding one of these integers to the rDocProc constant:

Window definition ID

Diameters
of curvature

rDocProc 16, 16
rDocProc + 2 4, 4
rDocProc + 4 6, 6
rDocProc + 6 10, 10
kWindowDocumentProc
Appearance-compliant movable window with no size box or zoom box. Available with Appearance 1.0 and later.
kWindowGrowDocumentProc
Appearance-compliant standard document window (movable window with size box). Available with Appearance 1.0 and later.
kWindowVertZoomDocumentProc
Appearance-compliant window with vertical zoom box and no size box. Available with Appearance 1.0 and later.
kWindowVertZoomGrowDocumentProc
Appearance-compliant window with vertical zoom box and size box. Available with Appearance 1.0 and later.
kWindowHorizZoomDocumentProc
Appearance-compliant window with horizontal zoom box and no size box. Available with Appearance 1.0 and later.
kWindowHorizZoomGrowDocumentProc
Appearance-compliant window with horizontal zoom box and size box. Available with Appearance 1.0 and later.
kWindowFullZoomDocumentProc
Appearance-compliant window with full zoom box and no size box. Available with Appearance 1.0 and later.
kWindowFullZoomGrowDocumentProc
Appearance-compliant window with full zoom box and size box. Available with Appearance 1.0 and later.
kWindowPlainDialogProc
Appearance-compliant modeless dialog box. Available with Appearance 1.0 and later.
kWindowShadowDialogProc
Appearance-compliant modeless dialog box with shadow. Available with Appearance 1.0 and later.
kWindowModalDialogProc
Appearance-compliant modal dialog box. Available with Appearance 1.0 and later.
kWindowMovableModalDialogProc
Appearance-compliant movable modal dialog box. Available with Appearance 1.0 and later.
kWindowAlertProc
Appearance-compliant alert box. Available with Appearance 1.0 and later.
kWindowMovableAlertProc
Appearance-compliant movable alert box. Available with Appearance 1.0 and later.
kWindowMovableModalGrowProc
Appearance-compliant movable modal dialog box with size box. Available with Appearance 1.0.1 and later.
kWindowFloatProc
Appearance-compliant utility (floating) window with no size box or zoom box. Available with Appearance 1.0 and later.
kWindowFloatGrowProc
Appearance-compliant utility (floating) window with a size box. Available with Appearance 1.0 and later.
kWindowFloatVertZoomProc
Appearance-compliant utility (floating) window with a vertical zoom box. Available with Appearance 1.0 and later.
kWindowFloatVertZoomGrowProc
Appearance-compliant utility (floating) window with a vertical zoom box and size box. Available with Appearance 1.0 and later.
kWindowFloatHorizZoomProc
Appearance-compliant utility (floating) window with a horizontal zoom box. Available with Appearance 1.0 and later.
kWindowFloatHorizZoomGrowProc
Appearance-compliant utility (floating) window with a horizontal zoom box and size box. Available with Appearance 1.0 and later.
kWindowFloatFullZoomProc
Appearance-compliant utility (floating) window with full zoom box. Available with Appearance 1.0 and later.
kWindowFloatFullZoomGrowProc
Appearance-compliant utility (floating) window with full zoom box and size box. Available with Appearance 1.0 and later.
kWindowFloatSideProc
Appearance-compliant utility (floating) window with side title bar. Available with Appearance 1.0 and later.
kWindowFloatSideGrowProc
Appearance-compliant utility (floating) window with side title bar and size box. Available with Appearance 1.0 and later.
kWindowFloatSideVertZoomProc
Appearance-compliant utility (floating) window with side title bar and vertical zoom box. Available with Appearance 1.0 and later.
kWindowFloatSideVertZoomGrowProc
Appearance-compliant utility (floating) window with side title bar, vertical zoom box, and size box. Available with Appearance 1.0 and later.
kWindowFloatSideHorizZoomProc
Appearance-compliant utility (floating) window with side title bar and horizontal zoom box. Available with Appearance 1.0 and later.
kWindowFloatSideHorizZoomGrowProc
Appearance-compliant utility (floating) window with side title bar, horizontal zoom box, and size box. Available with Appearance 1.0 and later.
kWindowFloatSideFullZoomProc
Appearance-compliant utility (floating) window with side title bar and full zoom box. Available with Appearance 1.0 and later.
kWindowFloatSideFullZoomGrowProc
Appearance-compliant utility (floating) window with side title bar, full zoom box, and size box. Available with Appearance 1.0 and later.
floatProc
Pre-Appearance utility (floating) window with no size box or zoom box.
floatGrowProc
Pre-Appearance utility (floating) window with size box.
floatZoomProc
Pre-Appearance utility (floating) window with zoom box.
floatZoomGrowProc
Pre-Appearance utility (floating) window with size box and zoom box.
floatSideProc
Pre-Appearance utility (floating) window with side title bar and no size or zoom box.
floatSideGrowProc
Pre-Appearance utility (floating) window with side title bar and size box.
floatSideZoomProc
Pre-Appearance utility (floating) window with side title bar and zoom box.
floatSideZoomGrowProc
Pre-Appearance utility (floating) window with side title bar, size box, and zoom box.

© 1998 Apple Computer, Inc. - (Last Updated 19 Nov 98)

Previous | Back Up One Level | Next |